home *** CD-ROM | disk | FTP | other *** search
/ Complete Linux / Complete Linux.iso / docs / apps / database / ingres04.lzh / doc / quel / append.doc next >
Encoding:
Text File  |  1992-11-19  |  2.4 KB  |  61 lines
  1.  
  2.  
  3.  
  4.  
  5.      APPEND(QUEL)                 1/26/79                 APPEND(QUEL)
  6.  
  7.  
  8.  
  9.      NAME
  10.           append - append tuples to a relation
  11.  
  12.      SYNOPSIS
  13.           _a_p_p_e_n_d [_t_o] relname (target_list) [_w_h_e_r_e qual]
  14.  
  15.      DESCRIPTION
  16.           _A_p_p_e_n_d adds tuples which satisfy the qualification  to  _r_e_l_-
  17.           _n_a_m_e.   _R_e_l_n_a_m_e  must  be  the name of an existing relation.
  18.           The _t_a_r_g_e_t__l_i_s_t specifies the values of the attributes to be
  19.           appended  to _r_e_l_n_a_m_e.  The domains may be listed in any ord-
  20.           er.  Attributes of the result relation which do  not  appear
  21.           in  the _t_a_r_g_e_t__l_i_s_t as result_attnames (either explicitly or
  22.           by default) are assigned default values of  0,  for  numeric
  23.           attributes, or blank, for character attributes.
  24.  
  25.           Values or expressions of any numeric type may be used to set
  26.           the value of a numeric type domain. Conversion to the result
  27.           domain type takes place.  Numeric values cannot be  directly
  28.           assigned  to  character domains.  Conversion from numeric to
  29.           character  can  be  done  using  the  _a_s_c_i_i  operator   (see
  30.           quel(quel)).   Character  values cannot be directly assigned
  31.           to numeric domains.  Use the _i_n_t_1, _i_n_t_2, etc.  functions  to
  32.           convert character values to numeric (see quel(quel)).
  33.  
  34.           The keyword _a_l_l can be used when it is desired to append all
  35.           domains of a relation.
  36.  
  37.           An _a_p_p_e_n_d may only be issued by the owner of the relation or
  38.           a user with _a_p_p_e_n_d permission on the given relation.
  39.  
  40.      EXAMPLE
  41.           /* Make new employee Jones work for Smith */
  42.              range of n is newemp
  43.              append to emp(n.name, n.sal, mgr = "Smith", bdate = 1975-n.age)
  44.                           where n.name = "Jones"
  45.           /* Append the newemp1 relation to newemp */
  46.              range of n1 is newemp1
  47.              append to newemp(n1.all)
  48.  
  49.      SEE ALSO
  50.           copy(quel), permit(quel), quel(quel), retrieve(quel)
  51.  
  52.      DIAGNOSTICS
  53.           Use of a numeric type expression to  set  a  character  type
  54.           domain or vice versa will produce diagnostics.
  55.  
  56.      BUGS
  57.           Duplicate tuples appended to a relation stored as a  ``paged
  58.           heap'' (unkeyed, unstructured) are not removed.
  59.  
  60.  
  61.